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THE ATARI ASSEMBLER EDITOR 
(Part 2) 
by Charles Brown 



In the first article I tried to introduce you to machine 
language programming * In this article I will try to give you a 
1 i 1 1 1 e more information on i t * 



In order to program in machi ne language, you have to know 
something about the different numbering systems „ In computer 
programming there are 3 numbering formats. These are decimal ? 
hexadecimal and binary. In case you dorr" t know decimal is a base 
10 system. Hexadecimal is a base 16 system- Binary is a base 2 
system „ I have included a short chart comparing these three 
systems: 
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The knowledge of these 3 numbering systems is very useful . 
Without them,, it would be very hard to understand what is 
happen! ng . 

When you start entering a source program in the editor mode, 
the first line of code tells the computer where to store the 
objE^ct code in location 600 (hexadecimal ) „ This is converted to 
1536 in decimal form- I bet you have heard of this location 
before. One of the most important features of machi ng language is 
the accumulator? a special register that is used very frequently 
in a program » To see how this is used 1 will show you how it is 
used- Let's say that we want to put the value 64 into memory 
location 710 decimal . This would change your screen color to red. 
In Basic you wuld simply use Poke 710,, 64 = In machine language 
you would first load the accumulator with number 64 . The command 



would look like this: LDA #64., Then you. would store the contents 
of- the accumulator into memory location 710 (the screen col or 
1 ocati on ) : ST A 7 1 0 . In this example you could perform tis task 
in Basic with one command » In machine language it would take two 
commands,, Anytime you want to change the value of something ? you 
almost always use the ac cumul at or „ 



In thi s art i cl e I have tried to show you a little more about 
machine language programming: understanding the numbering 

systems how to tell the computer where to store your program and 
the use of the accumul ator . These 3 things will help you 
understand what machine language is all about . 



THE EDITOR'S COLUMN 
by Norman Knapp 

liy column will be rather short this month ? but there are a 
couple of items I would like to bring to your attention* In 
September ACE of Columbus will be electing of f i cer s for the 
f o 1 1 ow i n g year « P 1 ease ser i ous 1 y c on s i der r un n i n g f or an office. 
You do not have to be an "expert Atari an" to do an adequate job. 
ACE of Columbus needs offiers who have the vision to set up and 
r u n p r o g r a m s t o s a t i s f y t he needs of t h e m e m b e r s h i p - 



Th e c ur r en t off i cer s ar e wor k i n g on a c on st i t ut i on wh i c h will 
facilitate transfer of leadership- This document better define 
the operation of ACE: of Columbus and the part each officer has in 
its operation. The constitution is also required to satisfy legal 
requirements for the status of ACE of Columbus as a nonprofit 
or g an i z at i on „ 



Don t forget that the next meeting of the SIGs is July 25 at 
the State Savings Bank in Worthi ngton « Please read the 
announcement on the last page of the newsletter « 



SOFTWARE REVIEW" MICRO LEAGUE BASEBALL 



Reviewed by Charles Brown 

There i s a pretty good game on the market -for our Atari ? 
Micro League Baseball put out by the Micro League Sports 
Assoc i at i on . I have to say it is definitely a different game -from 
the others . I actually hate basebal 1 ? but I enjoy playing this 
game « 

It is not like joystick controlled game that rely on quick 
reflexes- This game doesn't even use a joystick* It is played 
with the keyboard „ When you load the game you are given 3 
options. One is to start a new game* Another is to continue a 
previously saved game . The last option is to see a demonstration 
of the game* If you choose the new game option you will be shown 
a choice of different teams. These are actual teams that have 
played major league baseball. Some of these teams are supposed to 
be among the best in basebal 1 . They include the 75 Reds, the 73 
Athletics, and the 27 Yankees. For those who watch baseball I am 
sure you will recognize these teams. You choose first the 
visiting team. Then you decide if you or the computer wi 1 1 manage 
it* Then you choose the home team. Once again you decide if you 
or computer will manage it. This game can be played against 
another person or the computer. I think you can even have the 
computer compete against itself. Once you have made your choices 
then you will be given an option to use a designated hitter o?'- 
not . 

After the disk drive runs for a little while, you will be 
shown the players. Then you will be shown the visiting team's 
pitching staff. This includes the starter and the bench. You can 
leave the starter as is or choose any pitcher on the bench . It 
will show you a complete chart of the pitchers 1 ' stats to help you 
decide. Once you have made your choice you should exit by hitting 
the escape key. Then you will do thee same for the home team 
pitcher. Once again you hit the escape key to leave this mode- 
After you are finished with the pitchers, you will be shown 
the visiting team's lineups and their stats. This includes the 
starters and the players on the bench. You can leave the lineup 
as is or change it. If you decide to change it you have several 
options. You can replace the starters with players on the bench. 
You can also change the batting order for the starting lineup. 
You can even change the fielding postions for the starting 
p I ayer s . Wh en you are s t ud y i n g t h e p a 1 yer s you have 3 d i f f er en t 
screens of the stats to help you decide. When you hit the escape 
key 5 you will be able? to do the same for the home team. When you 
hit the escape key for the 4th time you can then start the game. 

The defensive team has many options to choose from. You may 
choose from 4 different pitches. You have several different 
defensive options to use such as pitch out ? corners in, or bring 
the whole infield in to cut the run off at the plate. 

The offensive team also has some options to choose from. 
When no one is on base, the batter has 2 choices. He can either 
swing away or make a surprise bunt. If there is someone on base 
then the batter has more options to use. He can either hit wi th 
aggressive base running 9 hit with safe running , have a runner 



s t e al n o r ci o a h :i t a n d r u n ... 



From what I understand when both the offensive and defensive 
options are chosen , then the computer will use the pitcher's stats 
and the batter *" s stats under that particular si tuati on and make a 
deci si on as to what wi 1 1 happen. You wi 1 1 actually see the ball 
being hit, the pi ayers catch the bal 1 , and the runners run the 
bases- You can even see the pi ayers slide into the bases. What 
is so amazing is that the computer knows who the pi ayers are. Say 
for instance if you fly out to center field the comuter wi 1 1 tel 1 
you who caught the ball* The computer also knows who is running 
the bases . For example., let's say you are the 75 Reds* The first 
2 players get on base and the 3rd man up hits a home run- Then as 
you see the pi ayers run the bases, the computer wi 1 1 tel 1 you that 
Rose has scored. Then it wi 1 1 tell you that Morgan scored 
f ol 1 owed by Bench . With this game hou can even bring in a relief 
pitcher if your starter gets in trouble. The offensive manager 
can bring in other players too. He can use a pinch hi tter or a 
pi nch runner . 

In trying to be honest I do see 2 draw. backs to this game. 
The first is that if 2 people are pi ayi ng they both have to use 
the keyboard. This way one-? can see what the other is going to do. 
For example if the defensive manager sees the offensive mamager 
hit 3 for a steal. Then most likely the defensive manager will 
hit 5 for a pitch out. Unless he has an awful 1 y poor catcher or a 
world class sprinter on base. The offensive manager wouldn't have 
a chance. The other flaw is when you play" against the computer. 
You have a certain batter up against a certain pitcher. Then you 
hit a key to make your offensive choice. Then all of sudden the 
computer decides to bring in a different pitcher. You are then 
stuck with the choice you had make for the -forroEir pitcher. I 
think that, if the computer decides to change pitchers, then you 
should be given a chance to make your offensive choices again. 

I also feel there is a pretty good future for this game. 
They already have other data disks for this game. For ex amp 1 e , 
they have a disk out for the complete 84 season. It contains the 
players and the stats for all 26 teams from the last year . There 
are also other disks available. These will give a wide choice of 
other teams to choose from, both past and present. There is also 
a general manager's disk available. With this disk you can trade 
players back and forth between teams. I even think that you can 
create your own team. This will make it a really interesting 
game. You could almost call this a game generator type game, a 
type that I really enjoy. 



Even though I find the game of baseball boring ? I really 
enjoy playing this one. I strongly suggest that you should look 
into this one. 



Mac hi ne Languages what Does It Al 1 Me an ? 
Bv Dr. barren G . Lieual len 



In previous discussions,, we have examined both how to 
load and store a machine language program, and a simplistic 
view ot how the hexadecimal codes produce any' meaningful 
results. This article will now deal with the spec i -fie 
commands available in the assembly language, and how they 
work to comprise a complete, working program., 

To make machine language programming a little easier tor 
human beings, it was decided that the numerical codes which 
represent the actual commands would be given an associated 
i: mn emon i c l! wor d , or 1 ab e 1 „ d esc r ibing the c omman d . A 
mnemonic is simply something which makes remembering easier, 
due to associations which may be made between the mnemonic 
itself and the item being remembered . In other words, the 
comiTiand which is represented by the number 76 <or U 4C" in 
hexadecimal) is also indicated by the mnemonic label !! JMP n , 
which stands tor "jump". This JMP command is very similar to 
the GOTO command in BASIC, which is essentially a !l jump !! in 
the program's execution. So, by remembering 11 JMP 11 , you can 
remember how this command -functions (just like remembering 
n GOTO 11 i n BASIC ) . 

All the mnemonic labels have been reduced to three 
letters in length for the sake of consistency. Therefore, 
it's not too difficult to create a program which will accept 
the three—letter mnemonics., and convert them into the 
appropriate numerical codes, thereby saving us the trouble of 
looking all of them up in a table and performing the 
con versi on our sel ves . Th is i s ex act 1 y what the var i ous 
assembler/editor programs do (of course, they also do a lot 
more, but that's another story, or at least another 
article!). In this way, all we need to remember is the 
mnemonic labels, and not concern our si eves with the actual 
numerical , hexadecimal codes. 

Previous newsletter articles by Charles Brown have 
d i sc ussed t h at ever y t h i n g your A t ar i does i s t h e r esu 1 1 of 
changing certain memory locations, either with PEEK'S and 
POKE'S, or Just with other BASIC commands, which alter the 
memory locations for you (whether you realize it or not!). 
Machine language is no different; everything happens because 
of changes in the memory locations. The only di f f erence is 
that in machine language, you do. have to be aware of these 
changes, because it is your machine code which will produce 
these changes. BASIC'S extra "helping hand" is no longer- 
available, and much of the housekeeping functions must be 
dealt with by you directly. In actuality, this is not as bad 
as it sounds. 



The simple screen-fill routine we discussed last month 



will serve as a good ex amp 1 e. This routine was made up of 
thirty-tour numbers, which correspond to the thirty-four 
commands in this program. Here is the source code for that 
program (The "source code 1 ' is the set of mnemonics., 
understood by your assembler, and hopefully by you as well; 
the "object code 1 ' is the set of numbers generated by the 
source code, and saved as a binary load file.): 



Byte 1 = 


PLA 


— 


get # of arguments 






CMP 




is it 1? 






BNE 


(#-2) ~ 


if not , k i 1 1 program (infinite 


1 oop ) 




PLA 


— 


get MSB of argument (not needed ) 




PLA 




get LSB of argument (character 


code) 




TAX 




store it in X 






LDA 


$58 ~ 


store contents of $58 in A and. 






STA 


$cc - 


store A in location $CC 






LDA 


$59 


store contents of $5? in A and - 






STA 


$CD - 


store A in location $CD 






TXA 




retrieve the argument into A 






LDY 


#0 


let Y=0 




LOOP-> 


STA 


$CC, Y- 


store A at location ($CC-VY) 






INC 


$CC - 


i ncr ement 1 ocat l on $CC 






BNE 


(#-6) - 


if $CC< >0 then go back to loop 






INC 


$CD - 


increment $CD 






LDX 


$CD - 


store location $CD into X 






CPX 


#$A0 - 


camp ar e X wit h $ AO ( 1 60 ) 






BNE 


(#-14) ~ 


i f X< > 1 60 then go bac k - to 1 oop 




Byte 34 


=RTS 




return to BASIC 





Depending on your background, this listing may or may not 
make any sense! What is shows, though, is that this program 
works exact 1 y like its BASIC counterpart — it places the 
internal code for an asterisk in the memory locations 
corresponding to the graphics zero screen display* It does 
this by first checking to see that only one number was 
recieved (this number Lthe argument! is the internal code for 
an asterisk., which you specified in the USR call from BASIC., 
eg* X=US'R ( 1536, 10.) - ) . It then transfers this value to the X 
r eg i st er ( a sp ec i a 1 memor y locati on used to hold v a I Lies 
needed in the program. Just as variables do in BASIC) , and 
then gets and stores the pointer to the beginning of screen 
memory (this is location $58 in hexadecimal ) - It then 
retrieves the character code, and begins to place it in the 
memory locations- The rest of the program simply counts how 
many locations have been filled;, increments the screen 
pointer and stops when one screen-full is done! A slightly- 
more detailed discussion can be found in "Atari BASIC Faster 
and Better " , by Carl M„ Evans (published by IJG Enterprises) « 



So, although you may not think so just yet , that's all 
there is to pr ogrammi ng in machine language. While it 
certainly seems harder than other programming languages at 
first, with a little practi ce and f ami 1 i ar i ty , you'll find 
that it really is, just another language in which programs may 
be written., Best of 1 uc k ! 



Book Review" "Presenting the ATARI ST", by L « English and J „ 
Walkowiak, Abacus Software, 1984, $15. 

Reviewed by Norman Knapp 



The introduction of a new computer has usually been 
accompanied by the introduction of new books and magazines. To my 
knowledge, this is the first book about the Atari ST computers. 
Since there is a lag time of several months in publishing books, 
some of the mater i al in this book may not be current . The status 
of the GEM (Grapics Envi ronment Manager ) operating system is 
uncertain as of this date. Is GEM going to be in RAM or ROM or is 
it even going to be released with the first STs? This book 
assumes that GEM will be in RDM and i 1 1 ust rates the f r i endl i ness 
of the ST r More about this I ater * 



With introduction of the ST ? Atari has broken cont i nui ty with 
past models by basing operation of the ST around the 68000 
microprocessor,, There are two reasons for going to the 68000 
processor: greater speed and direct access to larger amounts of 
memory., In the first chapter the authors present a brief 
comparison between the 8 bit (6502, 2--80, 8088 3 8086) and 16 bit 
microprocessors. The pin layout, register set , operands, and 
instruction set for the 68000 processor are presented as well as 
its advanced f eatureE. The capabilities of "the 68000 are that it 
is suitable for mi crocomputer systems with lots of memory, 
supports separation between operating system and user programs, 
supports multi-user appl i cat i ons, and implements modern high level 
1 anguages. 



Perhaps the most publicized feature of the ST has been it 
architecture* I'll just briefly mention it main features: 192 K 
system ROM, 128 K ROM expansion cartridge, and 512 K RAM for the 
512ST. The 128 K ROM can be used for either operating system 
expansion or for user programs- In addition, 32 K of address 
range is reserved for peripherals. Of the 512 K RAM, 32 K is 
required for screen RAM. The peripheral interfaces and devices ST 
supports are: 

1 « Two 3.5 in d i s k d r i ves „ 

2. DMA interface for a 10 MB hard disk. 

3 r Centronics parallel printer inter-face. 

4. RS 232 interface. 

5. MIDI interface for control of external music synthesizers. 

6 . Two j oyst i ck ports, one for a mouse. 

7. Video connections for B/W and RGB col or moni tors. 

8. Intelligent keyboard . 

Just a few words about the Di rect Memory Access (DMA) interface. 
This is what I consider to be the most important feature of the 
ST. Data is transferred (bypassing the 68000 processor) between 
mass storage and the computer at 1.33 MB per second the same 
speed at which the 68000 processor reads data from memory. In 
effect,, at transfer rates this high 3 the entire hard disk memory 
can be considered to be part of RAM (virtual memory). 



The chapter on the ST operating system was a little puzzling 



since it started out with a discussion of CP/M (Control Program 
f or Microcomputers) unt i 1 it was pointed out that two sections of 
CP/M had rewritten for the 63000 microprocessor- Thi s new ver si on 
of CP/M is called TOES* (Tamiel Operating System) by the authors and 
is stored in ROM; the user loses no RAM to TOS. If the new ST 
ower is familiar with the DOS commands of DOS-XL and OS/A-*-, he 
will find the transition to TOS fairly easy. 



Many Atari users will mi ss the f ami 1 ar DOS 2 menu and its 
ease of use. However ? the ST has built GEM into the user 
interface. GEM takes the CP/M functions such as formatting a 
disk, looking at the directory, copying files,, erasing files-., 
system status, etc. and replaces them symbols of commonly used 
of f i ce items'! desktop , mani 1 a folders, blank paper , pens ? 
erasers, trash cans, calculator clock., copy machi ng , etc . These 
symbols are manipulated by a technique called windowing using a 
track ball device called a mouse. The objects referred to above 
are called i cons ,. Moving the mouse on a smooth surface moves an 
arrow on the screen to the desired icon where it is activated by 
clicking the mouse? button. The the icon is then displayed in 
reverse. If for example the arrow points to a disk drive icon and 
the mouse if clicked, then when the arrow points to FILE." and the 
mouse button is held down , a pull down menu appears. After the 
arr own is moved to the OPEN choice and the button is rel eased , the 
pull down menu disappears,, another window appears displaying the 
contents of disk as icons. Moving the arrow to VIEW and holding 
the mouse button down makes another pulldown menu appear. Moving 
the arrow to SHOW AS TE'XT and releasing the button makes the menu 
disappear permitting the file to foe displayed as text. After the 
user is finished with a window, it closed by pointing the arrow to 
the box in the upper left corner of the window and clicking the 
mouse. The window disappears. The windows can be scrolled to 
display more icons than can fit on a single screen. The window 
size can also be changed. Windows can overlay one another. This 
is just one example of how GEM operates* The authors illustrate 
several other uses as well as more advanced -features of GEM. On 
the early STs, GEM will be in RAM and stored on disk. Later 
versions of GEM will be on a ROM chip thus f reei ng more RAM f or 
u ser ap p I i c at i on s . 



For the more advanced user, those who wish to create their 
own programs, the ST i s also an exciting machi ne. TOS has built 
into it a simple line oriented editor for creating source files 
for assemblers and compilers;, an assembler for conversion of 
assembly language source programs into machine code and DDT 
(dynamic debugging tool) for testing machine language programs. 
I'll have mention here that the editor 3 assembler, and DDT were 
descr i bed as CP/M commands. Let's hope that these commands are 
st i 11 in TOS. 



The higher levels languages which are being released along 
with the ST are BASS" I C and Logo. The authors do not elaborate on 
the implementation of Basic: for the ST, but do their best to 
convince you that Logo should be seriously considered as a 
versatile programming tool for the ST. You dorr't need to buy this 
book to investigate this for your sel f . Just look at the back 
issues of our newsl etter containing the Atari ciemopaks whi c:h deal 



with Logo » 



Is this hook really an "in-depth look" at a sensational new 
computer,, I do not think that this book discusses the features of 
the ST 11 in depth" because I could not use it as a reference book. 
This book is more in the style of an incomplete "overview" of a 
sensational new computer . The print font used throughout this 
book is large and there is quite a bit of space between lines to 
stretch the text over just 196 pages. There are also quite a few 
one and two sentence paragraphs,, In addition, the time limit of 
three months the authors set for themselves between receiving 
their ST and the delivery date of the manuscript indicates to me 
that much material may have been left out. There is also the 
possibility that some material may have been deleted during the 
translation from German to English. There is wr i t ten on the spine 
" Vo 1 . 1 " wh i c h :!. mp lies t hat a sec on d vo I ume may f o 1 1 ow ; this i s 
not indicated in the text* 



I think that it is good that an overview has been written for 
the ST. The neophyte user such as myself needs one to view the 
forest before plunging into the bushes and trees. Let's hope that 
the manuals that will come with the ST and its accompany software 
fill in the gap. 



PRINT SHOP Tip 
by Norman Knapp 



There is in PRINT SHOP an editor for creating your own 
graphics symbols. This editor is easier to use than the 
explanation given in the manual. The cursor may be moved about 
the screen using a joystick rather than the cursor control keys. 
The user may toggle between the Drawing and Erasing modes by 
pressing the D and E keys. The important point to remember is 
that the current mode i s act i vated on 1 y wh i 1 e the f i r i ng button of 
the joystick is pressed? this procedure makes it much easier to 
do rough drawing and editing. For more precise cursor control , 
the user may revert back to keyboard cursor control ? activating 
the current editor mode when required by pressing the firing 
button. 



The Atari logo on the cover of this issue was created using 
thi s t echini que. 



ft M ixi O U 3x1 C EE M EZ ixll "T ! 



The Special Interest Groups <SIb : ' s) of the Atari Computer 
Enthusiasts at Columbus have been quite popular since their 
•formation several months ago. Currently groups dealing with 
programmi ng 1 anguages , tel ecommuni cati ons, and adventure 
gaming are in -full swing. Another part of the Sib meetings 
which have been very popular have been demonstrations given 
on the use of AtariWriter (by Kathy Fellows) and on printer 
usage and utilities (by Dr. barren Lieuallen) . These 
i n -formal , back and forth discussions have helped many people 
understand how to use their Atari to its fullest potential. 
Because these demos have been so well-received, and so much 
f nn , I'd like to offer the following list of other 
possibilities for some newly-forming branches , or 
demonstrations to the Special Interest Groups s 

A„ An introduction to machine and assembly language 

B . A FORTH tutorial and demonstration 

C. A graphics utilities demonstration, including simple 
an i mat i on and pi ay er -m i ss 1 e g r ap hie s 

l/D. Various approaches to music on the Atari systems 

y E, Basic spreadsheet operation and uses 

F„ Intermediate to advanced disk analysis utilities, and 
repairing "mangled" files 

G . Writing your own BASIC and machine language adventure 
games 

And More: 

If even slight interest is shown in any one or more of 
these topics. Warren would be more than happy to begin 
scheduling the sessions, either in conjunction with the 
regular ACEC meetings, SIG meetings, or as a separate 
ACEC-sponser ed 11 mi ni --course" u 

Please contact Warren during the "intermission",, or after 
the meeting tonight if you woul d be interested in any of 
these groups , or if you have some other area in which you 
wou id like t o particip at e i n a demonstration an d / or 
d i scussi on . 



